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Introduction 


The Cromemco TRACE program enables the user to test and debug 
programs. TRACE emulates the behavior of a 2-88 vrocessor as it 
follows the logic of the user ovrogram, providing a selection of 
reports of the processor state so as to minimize extraneous printing. 

TRACE operates as part of DERBUC, Cromemco's assembly language 
debugging program. DEBUG is automatically loaded along with TRACE, 
and actS as a monitor for TRACE. In this manual the terms "monitor" 
and "DEBUG" are used interchangeably. 

TRACE Options include control of register disolay, choice of 
display frequency, i.e. after every instruction, after every branch, 
at CDOS calls only, and with register history written to a circular 
queue for display after returning to the DEBUG monitor. 

Features which help the user locate errors quickly iaclide 
warnings if the user writes to unexpected areas, sinulation of 
Input/Output commands on the console, warnings of attempts to execute 
undefined commands, undefined calls to CDOS routines, improper return 
from subroutine calls, and execution of branch instructions or Jjecimal 
adjust if the relevant flags are in an undefined state. 

TRACE also allows the user to sinulate interrupts and queues then 
in order of priority. 

If execution time is critical to the application, TRACE can 
display cumulative machine cycles at each step or on return to the 
monitor. 


——— a ea oe eel 


Instructions 


TRACE includes all the commands available in DERUG as well as 
some special commands to access summary information developed by a 
trace of a user progran. A complete summary of TRACE commands 
follows. 


ee a eee ee ne ee a eae eee coe eee me ee ce oe 


ae te cee a ee ee i a ee ae a ee a ee an ce oun a ee a 


The format of CONTINUE is 


Cc (CR) 
C number-of-lines (CR) 
C# (CR) 


The first format traces the program through one instruction. The 
second format traces the user program through "number-of-lines" 
instructions, displaying the registers in accordance with the ootions 
entered following the "T" command described below. “number of lines" 
is entered as a hexadecimal number. You may trace through RAM or FCM. 

The third format "C#" will cause the user program to be simulated 
continously, or until encountering a STOP ADCRESS, a HALT command, RST 


ee te RRA MAY NraAntram 
me wes 3WYnH OF S@EVELTeE CLEVES bib FUS VOCS paves 
on hit any key on the console, ; ; z 4 

y «ey = To abort a trace during execut 


in progress will be completed, Displays from the simulated instruction 


2 


Introduction To Trace 


~-he user registers will be preserved, and control returns to the 
monitor. 


ee cree Se Ree ee ate ae SS SED me Um ET ere ete Ae ce eee ee me oe ee ee ee ee oe ee 


The "CN" command is the same as the “"C" command except that 
register display is suroressed. 


om me eee ee ee om ce oe eee ee cee oe ee ee ee ee ee ee ee ee 


ee ee ae ee ee ree A me ee cere ae ee ee ee ane ee ee ee ee ee ee ee 


The circular queve showing the last 198 branches or the last 109 
instructions simulated is displayed. 


oe ee re eee oe a ee om oe ee me ee oe 


ee ce ee we oe ee me re me oe ee 


The total number of simulated machine cycles from the last 'T' 
command is displayed as a decimal number. Time spent in user Cros 
calls or real time segments of the user program is not included. This 
cycle count assumes memory with no wait states. 


a ee ce nem a ae ane ce ee em re nee me ee ee ee ee em ce ty ee ee ae ee te ee te ee ee ee 


TU (CR) - Upper contents of User stack to CALL Stack 


ee me One a cee ae Sn oe me Se Se Oe Oe me Nee om eee eee ee te eee ee em cee ae ee ee ee ee ee eee ee ee ee ee ee es ee 


This command sets the upper area of the TRACE "CALL" stack ecual 
to the 16 bytes above the user's stack pointer. If tracing starts 
inside up to 5 nested subroutines, TRACE will report no return errors 
if the return addresses were on the user's stack. 


eee ae re re oe te ee a ce ee ee ee ee ee re ee ee ee ee ee 


INITIALIZING SELECTED PARAMETERS 


Oe oe ee cee we em em ee me ee ee me ee cee coe ee oe ae ee ae ee ee a ee 


TRACE allows the user to initialize selected parameters at any 
time, 


The following commands: 


TH Initialize DATA area list 

TH Initialize HALT addresses 

TI Initialize simulated INTERRUPT list 

TN Initialize real time INPUT channel list 
TO Initialize real time OUTPUT channel list 
TP Initialize OPTIONS 

"R Initialize trace RESTAPT addresses 

aS Initialize trace STOP addresses 


are treated in detail in the satole trace below. 
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ee ate ee ee se eee ee ee ee ee ee ee ee ee 


ON a a ee te we ree ee ee ee te ee ee ee ee ee 


To initialize the parameters controlling the tracing of a user 
orogram tyne: 


T (CF) 


The following shows the use of TRACE to examine the action of the 
“rojram SAMPLE listed in chapter 5. The user resnonse is shown in 
upper case, the TRACE nromots are given in lower case. Fntering an 
"X' at any time following a TRACE vromnt will return control to the 


monitor. The user may enter the voaraneters requested by TPACE as 
address exrressions,. Withia these expressions addition,subtraction, 
the "ew" register, and "“S" (the current instruction counter) may be 
used. 

Start addr? 130 (CR) Simulation starts at the address 


entered. 


ee we em or ee we oe 


stoo addrs (5)? $+3B (CR) 

EGOO (CR) 

L (CR) A list of up to 5 addresses 
(maximum) at which tracing stops 
and control returns to the monitor. 
These addresses nust correspond to 
the first byte of an instruction in 
order iste) take effect. ‘L' 
terminates a list. 


ee ee ee ee em ee oe ee ne ee ee ee se 


OU ee ee eee ere ee mee we ee ee ee ee 


Gata areas (1°) low addr,hiqh addr 
134, 1AC;3f Entec a maximum of 1° memory areas 
to which the user orogqrar writes. 
If the user nproqram writes to an 
address withinr these areec, no 
@érror is reoorted. 
Con@as Or so9aces may be used 
@s delimiters, carriage returns or 
semicolons separate items entered 
as sets (@.9.,nairs of addresses). 
If the stack area is not declared 
here, the message: @AAAA AAAA' 
MMMM MEMORY WRITE NOT IN SPECIFIEL 
RECION will be orinted after every 
stack writing oneration. 
After a CbpOS call, the 8 
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locations of the user stack used by 
CDOS will be printed. 


ee cee ere ee ee ee ee ee eae ee 


Cm ce crm mee cree cm ee ee ee ee ee eee 


display on write (13) low addr,high addr 
198 198+14 
L Enter a maximum of 19 areas witnia 
which a display of the contents of 
the memory is desired whenever the 
user program writes to these areas. 


extended opt (y or nn)? XY Type Y to enter the additional 
options listed below. 


oe em ee ee ee ee ie ae ee oe ee ee ee ee oe ee es oe 


a ee ae ee aa ate ee ee eee me ee ee ey ee ee ee 


real time: inp ch(1@)? 

FEL List up to 1% input channel oort 
addresses for which real time 
execution is desired. 


Oe he ee ee ne me ae ee a ee ee ce ae ee a 


eee ae ee a ee ee oe ee ee cee ee ee ae ne ee ee 


output ch (19)? 
FFL Cesignate um to 17 real tire ontont 
channels. In this exarnrle irours 
to the sense scwitcnes (tT PLT 3781) 
and outputs to the sense ligite 
(SOTPUT MEF) will »ve e2xocuted 
instead of simulated, 


trace stop (5)? 

@12F3L Entec up to 5 addresses at which 
control passes from TRACE to the 
user orograr, These wust be on 
instruction boundaries. This and 
the Following T8ACE restart option 
allow the user to avoid tracing 
through subroutine calls, timing 
loops, etc. 
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— oe ee ee oe —— ee eee ee 


trace restart (5)? 


132;L 


interrupts(19) 
118,7E,1,13 (CR) 


L (CR) 


interrupt mode 


options 


ENTRY 


WON Ue WN Fe 
t 
' 
' 


(2)? 


Enter to 5 


control 


up 


the user program. 
boundaries 


instruction 


addresses at which 


is to return to TRACE from 


These must be on 
and this 


portion of the user program must be 
writeable memory. 


ee 


,addr,comm,oass,times? 


Schedule up 


interrupts.Enterc 
the 
the 


at which 
interrupted, 


to 16 simulated 
the address (117) 
program will oe 
byte appearing on 


the data bus (7E),the rate at which 


the 


address will be interrupted 


(1 


for each time we pass this address, 


2 for 
the number of 
will be so 


interrupted 


every other time etc.), and 


the orogram 
by this 


times 


pattern (13 hex or 19 times). 


Initialize interrupt mode at 6,1,0r 
If other values are entered the 


is set at 6, anda 


orcinted if a simulated 
executed before the 


interrupt mode has been defined. 


? @ 
2. 
interrupt mode 
warning is 
interrupt is 

TP - 

9,2 The first entry 

what is ovrinted 


following table: 


ITEMS PRINTED 


ee ee eee ne oe ee ne ee 


eae re eee me wee a ee oe 


(OPT 1) controls 
according to the 


(PC) Instruction address 

" (F-A) Flags and Accumulator 

" -~ fe B,C Register Pair 

" - * - = " = D,E Register pair 

" - Sm Mem Be H,& Register Pair 

it -_ "Ww - - id -~ ~ Ww ~- HM ~ Ix Register 

n" u - — “ ~ ~ ” - - Ali - -_ wt _ ITY Register 
All of the above plus the disassembled command. 
All of the above olus the total machine cycles. 
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If a number for OPT 1 greater than 9 is entered, OPT 1 is set 
equal to 9. 

The second entry (OPT 2) determines when register display occurs 
according to the following rules: 


OPT 2 =1 Print on executing a branch instruction, (i. 
CALL,RET,JP,JR,RST). Print current address ( 
and the next instruction address, and continue 
directed by OPT l. 


OPT 2 =2 Print at every instruction as directed by Op7 l, 
OPT 2 #3 At every instruction write the Program counter, 


Flags,accumulator, and the additional register 
pair selected by OPT 1 to the circular queue as 


follows: 
OPT 1 <=3 BC register pair 
OPT 1 = 4 DE " 
OPT 1 = 5 HL " 
OPT 1 = 6 IX register 
OPT 1 = 7 IY " 
OPT 1 = 8 SP (stack pointer) 
OPT 1 = 9 (SP) contents of top of stack 
This data is written to the circular aqueve unless 
OPT 2=4, 
OPT 2=4 At each branch instruction, write the Program 
counter, next instruction address, flags and 


accumulator to the circular oveue. 

When a 9 command is given in resnonse to the 
prompt "-" the contents of the circular gueue are 
displayed, last instruction first. 

If a value greater than 4 is entered, Cr” 
is set equal to 4. 


a“ 
“4 


Control now passes to the monitor to allow the user to set 
registers, examine memory, or execute the user program until TRACE 
restart breakpoints cause control to pass to the TRACE program, or 
monitor breakpoints return control to the monitor. 

Typing "C#" causes TRACE to sinulate the user program starting at 
the address given in response to the "start addr?" prompt. 
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Data Entry Messages 


stop addrs (5)? 132 (CR) 
135;1527 

i 
error retype line 
125;1527 


In the example above the character "Z" was erroneously entered. 
TRACE types an I under the character in error, cromots “error retyoe 
line" and awaits the revised line. If a data entry containing such an 
error was made at the same line as a TPACRE promot, this error 
indicator will be offset to the right by the length of the promot. 


data areas (1%) low addr,high addr 
184,1A4C 

456,459;123:673,689 

too few,last= 9123 


Too few entries have been made for items required in sets. i.e. 
data areas, Sinulated interruots. "last= 9123" shows the value of the 
last item ovroperly read. In the example above, 9123 was entered 
without a corresponding upper boundary. The data area litits 678,689 
Tust also be reentered as they were not read. Should it not be clear 
to the user which data items must be reentered, return to monitor by 
entering "x! and enter the entire list under that category. 
Otherwise, enter the missing item and continue. 


Execution Time Messages 


CRAM (Data DAMags) 


Parameters stored by TRACE have been changed by the usec oroqram 
while the user program had control. TRACE may be reinitialized 
without reloading. 


@AAAA AAAA' INT MSXX T=VY¥Y INT=CO LEV=LL 
Situlated interruot at address AAAA, Interrunt mode. = YY, I 
Pegister= YY tne command on the interrupt line = CC, and the oriority 
level LL which points to the sinulated interrupt list. 


G@AAAA AAAAT ****** TNTEPRUP, VOLE UNDEFINED, ASSUME =3 


A sinulated interrupt occurs at address AAAA with the mode not 
previously defined. Tne tode is assumed to ne equal to 9. 
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@AAAA AAAA' ****** DAA WITH H FLAG INDEFINITE 


AT location AAAA a decimal adjust command (DAA) was executed with 
the half-carry (8) flag undefined. Trace continues. 


@AABA AAAA' ****** MMMM MEMORY WRITE NOT IN SPECIFIED RECIOM 


The commmand at address AAAA wrote to memory location “™“""™ which 
is neither in a declared data area nor in a " disnlay on write " area. 


@AAAA AAAA' ****** ¥XXKX to VYYY PLCCK MOVE WILL OVeINrintp TIS LE 


The command at address AAAA is a block transfer or a block input 
instruction which would write over itself. ‘Tracing halts and control 


returns to the monitor. 
PDA! (Program DAMage) 


The user program has chanjed memory occupied by TRACE 
instructions. Control returns to the monitor. Reload TRACE before 


proceeding. 
@AAAA AAAA' ****** CALL STACK OVERFLOW 


Following a CALL,RST, or a MODE 1 interrupt, the call stack has 
overflowed or underflowed, and the return address error following this 
‘"acning may be in error. 


@AAAA AAAA! ****** RETURN ERRCP MMMM WAS EXPECTED. 
ACTUAL RETURN ALDR= NNNN. 


Following a return instruction, the return address from the user 
stack (NNNN) does not agree with the return address (¥INM™) entered to 
both the user stack and the CALL stack at the last CALL,PST,or MOrE I 
interrupt. The sinulated program counter is set at address NTN‘ ane 
simulation proceeds. 


S/P NOT R/W 


The user orogram stack pointer was not assigned to PAN arce when 
a TRACE RESTART instruction returned control to TKACE, or the user 


program encountered a CDOS call. 

If this error message follows a trace restart instruction the 
proper restart address was not transferred through the stack to TFACE. 
Simulation halts andj control returns to the monitor. 

If the error message Follows a CLOS call, control passes to tae 
monitor before CCOS is called, as CDOS cannot be used with the user 


stack in a read only mode. 


@AAAA AAAA' ****** MMMM WRITE TO SYSTEM AREA 


Command attempted to write to address MMMM, within the TRACE or 
system area. 
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@AAAA AAABA! *** eee XXXK to YYVYY CLOCK NRITE TO SYSTrM APTA 


At address AAAA a block transfer or 3 block input instruction 
attempts to write to TRACE or the system area. Tracing halts and 


control returns to the monitor. 


G@AAAA AAAA' ****** XXXX to YYYY BLOCK MOVE KKAPS APOUND MEMORY 


At address AAAA a block transfec or block input command 
destination block wrans around upper to lower memory (addresses XXXX 
to YYYY). Tracing halts and control returns to the monitor. 


@AAAA AAAA' ****** TRANSFER ON INDEFINITE FLAG 


The flag controlling the transfer at instruction AAAA has been 
set by a command that leaves it in an indefinite state. 


G@AAAA AAAA' ***4%* UNDEFINED INSTPOCTION 
cccce 


The instruction at AAAA is a two byte unidentified command 
(cccC). Tracing halts and control passes to the vonitor. 


AAAA AAAAS ****** STOD ADDR 


Tracing has stocped at address AASA in the stoo addrecs list, or 
a monitor restart has been encountered. Vo continue tracing tyve tl! 
and the instruction at the stop address will be simulated and tracing 


will continue. 


SIMULATED INPUT/OUTPUT MESSAGES 


@AAAA AAAA' IN #YY 


This message indicates a simulated input is expected from the 
console, AAAA is the instruction address and YY is the input chaanel 
designated in hexadecimal. The user then enters the desired iaput 
data as a two digit hexadecimal number or as a siagle quote followed 


by an ASCII character. 
Examoles: 
@2908 IN #3 7A 


@2300 IN #2 'Q 


GAAAA AAAA' IN 4¥¥ SSSS TO TITT 
TYPE “ FOP MONITCR 


A block inout instruction at 4ASA will store input daca ir tre 
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region bounded by SSSS and TTTT. The user may enter the monitor by 
typing ©&M on the console and then substituting data directly into the 
memory area SSSS - TTT, or Fill this area with the Move command. As 


before YY is the input channel designation. 

If the user does not invoke the monitor, TRACE expects up to 24 
bytes of data per line and prompts with the destination address of the 
start of each line, and the total number of bytes remainina to be 
entered, The user may either enter the data as hexadecimal or ASCII 
preceded by a single guote. 


G@AAAA AAAAS OUT #YY XX A. 


This indicates a simulated oOutout on the console, where A*r\A is 
the instruction address, YY is the output channel Sesiqnation, vr is 
the output data in hexadecimal, and A is the ASCII eauivalent. A 
period follows the ASCII output to aid in detecting svxaces. tine feed 
is shown by 'LF', carriage return by ‘CR’. 


@AAAA AAAA' OUT #YY 
BBPP: N1 R,. N2 S. N3 T. 


This indicates a simulated block Outout at address AAAA, directed 
to port YY. The starting source address for each line is EEBE, 
followed by a colon. N1,NZ,N3 are the hex outouts, and F,S,T the 
corresponding ASCII outputs if these are Printing characters, else 
blanks are output in their place. Carriage return and line feed are 
displayed as 'CR' and 'LF' respectively. 


SIMULATED INTERRUPT OPTION 


Stet ett se see wee ee ee ee 


The user may enter in response to the prompt: 
interrupts (14) addr,comm,oass,tines? 
up to 12 simulated interrupt vatterns of the form 


AAAA,CC,PPPP,NNNM 


AAAA is the address of the command to be interrupted if 1iterrunt 
enable flag is set. 


cc is the command appearing on the interrupt line. 


PPPP is the number of times (in hexadecimal) we cass this address 
to execute the interrupt. Thus if PPPP=1 we execute the 
interrupt on every time the simulated program counter 
reaches AAAA, 


NNN 1s the number of tines this interrupt pattern is receated 
After NNNN interruots at this address, no further interrupt 
from this line occur. 


* 
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TF the Jinhenuints aren di valet the time. as. dpternor proonss sae. 
pending, the interrunt is executed at the second command following an 
interrunot enable. Tf two or more interrupts become pending, the 
pattern entered first under the initial simulated interrputs perompt is 
the interrupt of highest priority. 

If the interrupt mode changed while the user program was in 
control a simulated interrupt will not execute in the mode set under 


user control. 


CDOS Calls 


On encountering a transfer to the CEOS entry point (ordinarily 
CALL 5) TRACE verifies that the contents of the C-register request 
valid CDOS functions, and that any writing to memory is done to 
locations outside the TRACE or CDOS area, and that the user stack is 
in RAM. If the CDOS call writes to a disk, TRACE checks that the disk 
is logged on, displays a write to disk warning message on the console, 
and waits for the user to tyoe 'Y' as confirmation before performing a 
disk write. 

TRACE then executes the CDOS command and displays memory changes 
within display on write regions declared previously, and shows the 
results of any writing to memory outsije declared areas. The actual 
execution will not be displayed, however. 


ee eee 
Sse SS SSS SSS SSB SSS SSS SV TSS Stes sess Tes 


CEAINING PROCPA"S UNCER CLOS CONTROL 


ed eee 
SSS SSS SSS SS SS SSS STS SS TSS SS SS SSS SSS ST 


If TRACE encounters a CLOS chain command the following message is 
displayed on the console: 


CHAIN, TYPE € TO LOAD AWD PETURN TO PERUC, C TO CONTINUE. 


Responding with a ‘'D' loads the new program originating at 1763 
and returns to the monitor.Typing 'C' resumes tracing after the new 
program is loaded, and entering any other character returns control to 


the monitor. 
After chaining a new program the register contents are not 


predictabl2 and those shown by TRACE will not be the same as a CHAIN 


command performed under control of the usec program. 
when the new program is sucessfully loaded, TRACE sends a message 


CHAIN COMPLETE 
to the consols. . 


mse es eee eee ee ee 


CDOS CALL ERROP VESSACES 


SS SSB SPSS SESS SSS st TST TT ss ST 


Tae cheined program is not on the disk, or did not read vxronerly 
from the disk. Control passes to the monitor. 


12 


Introduction To Trace 


CHAIN FILE NOT A COM FILE 


The extent of the program called by CDOS is not 'COM', Control 
passes to the monitor. 


DISK NOT LOGGED ON 


An attempt was made to access a disk not logged on. Control 
passes to the monitor. 


INVALIP Cros CALL 


The contents of the C register do not indicate a valid CDOS 
routine. Control passes to the monitor. 


CLOS CRASH MESSAGE 
This is printed in lieu of the “INVALID JUMP TO LOCATION xXxxx" 
message reported by CDOS (due to executing a PST 7 instruction caused 
by defective memory, ocerhagos). Control then oasses to the monitor. 


CDOS WARK ROOT ATTEMPTED 


A program has attempted to reboot CIOS via a jump to location 
68398. Control passes to the monitor. 


— 
+r at —— 
a & 7 ee, in, renee sean eee — 
oe 
2 — SS ee ee ee es eee ee a oe ee ee 
- 
— 
— 


Trace Command Format 


The CROMEMCO TRACE vcrogram makes it possible to test and analyze 
usec programs. TRACE is loaded into memory and moved to the highest 
memory available below CDOS. When using a 32K crpos and TRACE, thece 
is 19K left for the user program. 


eee 
eee 
Loading Trace 


a 
TRACE is loaded by typing one of the following commands from Chos. 


TRACE 
TRACE filename.ext 


where "filename" is the naime of the program to be tested, and "ext" is 
the file extension. In both cases, TRACE is loaded into memory directly 
below CDOS. The CDOS jump instruction located at location 5H is changed 
to jump to the start of TRACE. This allows locations 6H and 7H to still 
point to the lowest available memory location. 

The second command above is used to load the file to be tested into 
memory. If the extension ("ext") is " HEX", then the file is read as an 
INTEL HEX file. Any other extension is read as an absolute binary file, 
loaded at location 140H. kee* NOTE **** TRACE does not load relocatable 
files. If an extension is ".REL”® it will be loaded in as if it were 
binary and will not be executable. 


ee 
rer TTS 
Control Characters 


ea 


Control characters are used in TRACE to help in entering 
commands. These control characters are the same as CLOsS uses. 


Control-c (“C) go back to CLOS 

Control-H (74) delete character and backsoace on CFT 
Control-U ("U) delete line ; 

Control-x (*X) delete character and echo 

underscore delete character and backsoace on CRT 
RUBout (DEL) delete character and backspace on CRT 
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During a nrinting (such as from the PM” command) the following 
characters may be used. 
Control-S (7S) stop/start printing. If printing, this 


character will stop the vrinting. If already 
stooped, this character will resume tie 


printing. 

break (or any other character) will abort the 
printing, orompt, and wait for the next 
command, 


Command Format 


TRACE is controlled by one and two character commands from 
the termwithal. The fornat is free-form in respect to spaces. Commas 
may be used in place of spaces. In the following, the examples all 
dump memory starting at location 1@09h and ending at location 19FFH. 


DM1406 13FF (CR) 
PM1@88S19@ (CR) 

D M 1486 LOFPF (CR) 
DP M 1988 S$ 1968 (CR) 
DM1489,10FF (CP) 
DM136@,S198 (CR) 

CDC M 41966 , l4FF (CP) 


@ Register 


TRACE was designed to give flexibility in testing relocatable 
programs. The "@" register is used to tell TRACE wnere the module 
you wish to debug is located. This address can tbe found fron 
the map generated by the linking loader "LINK". To change 
the "@" register, type "2d (CR)" on the console. The computer will then 
type "@-xxxx " (where xxxx 1s the current value of the register. The 
computer will then wait for.a new address. If a CR only is typed, the 
register remains unchanged. If an address and a CR is typed, then the 
register will contain the new address. The "«" register may now be 
used as part of an address. The Following examole demonstrates it's 


use. 


G/e @A3 1405 


This is an exanle of the go cormand. Treak noints will  7e set at 
the begqinninn of the current rodule, relstive locektion A?" ar tre 
Current -odule, ani at location 1L7fTH. This feature allows you to test 


a module without having to calculate atrsolute addreesec, 
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Address Expressions 


used. Within these expressions, addition, subtraction, 
is the current location of the program 


and the "S$" may be used. The "S$" 
If many modules are being tested, addition can be 


counter (P register). 
used to specify relative addresses. 


For additional ease in specifying addresses an expression can be 
the "@" register, 


G/2321+A3 
The voreceeding example would set a break point at relative location 


A3H if the module is located at 23218. 


Swath Operator 


There are two ways to specify the address range of nany commands. 
The first is to sinply list the beginning and end addresses (and where 
appropriate, the destination address). For example, the first command 
below programs the range @ through 13FFH into PROMs starting at location 
E4G6@H. The second command displays the contents of memory between 
addresses E49@H and E4@2H, 
PG 13FF €460 
DME406 £4@2 
Another way to do the same thing is to use the Swath operator, "S", 
to specify the width of the address range, rather than state the end 
address explicitly. 


PO $1400 E46 
DM £40653 


Errors 


Any errors made during “entering of a command may be corrected by 
typing Control-U ("U) to abort the line or by backspacing and correcting 
the line. If a CR has already been entered and TPRACF detects an 
error, the line will not be accented and a "?" will »be printed. 


Re-enter the line with the incorrect data corrected. 
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rr eR = 


Other Trace Commands 


The remaining TRACE commands are described in detail below. 
The operator must wait for promot character ("=") before entering the 
command. These commands are identical to those in PEBUC, the Cromemco 
Debugging Program. 


ee ae ee a an ee a ee a a an eee ca me am me ee me my eo 


eee mee cee ete ane ne ar see a SO SO ee Se oe ee iy nt ete Om SDD 


This command allows in-line assembly language to be assembled into 
memory. The command takes the following format. 


A beginning-addr (CR) 


The user is prompted with the absolute address, followed by the 
relative address. TRACE reads from the console the assembler mnemonics. 
and assembles the instruction into memory. The mnemonics for the various 
7-88 instructions can be found in the 2-88 CPU TECHNICAL MANUAL published 
by Mostek and Zilog. If there was no error in the instruction, it is 
stored in memory and the user is promoted for the next instruction. The 
The rules for address expressions aoply to the addresses in the assembler 
mnemonics. In the following examole the "@" register contains 12344. 


A@4a 

1274 9949' ADE 

1275 8@@41' CALL @93 
1278 @@44' JP 1432+95 
127B @G47'  . 


The A command tecminates when the first blank line or a line 
starting with a "." is entered from the console. If there is an error 
in the input line, it will not be accepted, a "?" will be printed and 
the console will be prompted with the addresses again. 


me ee ee es ee ee ee eee ee 


eee oe ae mn ee cae a 


The contents of memory are disolayed in hexadecimal forn. each 
line of the disolay is preceded by the address of the first byte and 
followed by the ASCII reoresentation of the hexadecimal bytes. An 
examole follows 


er1l4a,s3é 

C143@ 40 41 42 43 44 45 46 47-48 49 40 4p 4C 4D 4E 4F @ABCDEFGHIJKLMNO 
J11q@ 5A 51 52 53 54 55 56 57-58 59 SA 3@ 31 32 33 34 PORSTUVWXY7012734 
A12G 25 36 37 38 39 G8 9% AA-20 BF 3G GA AA GD GF AG SATII. «cece eeees 
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The formats of this command are as follows. 


DM (CR) 

DM beginning-addr (CR) 

DM beginning-addr ending-addr (CR) 
DM beginning-addr S swath-width (CR) 
DM,ending-addr (CR) 

DM S swath-width (CR) 


The first format displays memory from the CURRENT display address, 
initially 199H, and continues for 8 lines. The second format displays 
from the beginning address and continues for 8 lines. The third format 
displays from the beginning address to the ending address. The forth 
format displays from the beginning address for a length svecified by 
the swath-width. The fifth format displays From the CURRENT display 
address to the ending address. The sixth format displays from the 
CURRENT display address for a length specified by the swath-width. 

If an "X" is included after the "DM", the relative addresses are 
also printed. In the following example assume that the "@" register 


contains 1408. 


DMX144,S839 

190 GO8H3' 48 41 42 43 44 45 46 47-48 49 4A 42 4C 40 4E 4F @APOPAFCHIIKLM’ 
$116 6419' 38 51 52 53 54 55 56 57-58 59 5A 30 31 32 33 34 Bir 7 UVYXY¥7917234 
@12€@ 06829' 35 36 37 38 39 9@ 8H AB-GG BB 39 24 90 OD BO GA 56789........... 


2 cee ee ee ie ee a eee ee oes ee oe ee oe ee eee ae ee ee 


When TRACE is re-entered from a break point, the user registers 
are saved. The registers may be displayed at any time by typing the 
following command. 


-DR (CR) 
SZHVNCE A=99 EC=0000 DE=0090 HL=0906 S=0196 P=0198 61270' LD E,A 
SZHVNC A'=068 B'=9008 D'=9990 H'=8002 x=9000 Y=0000 I=88 


The letters "SZHVNC" are the flags, on the 2nd row are the prime 
flags. If the flag is on, it is printed, if the flag is off, a space is 
Orinted. If only the carry and zero flag are set then " 2 Cc" would be 
printed. The flags are described below. 


S - Sign flag, S=l if the “SE of the result is one, ie, the 
result is negative. 

2 - @ero flag, 221 if the result of an operation is zero. 

H - Walf-carry flag, H=l1 if the add operation oroduced a carry 
into the 4th bit of the accumulator or a subtract oneration 
produced a borrow from the 4th bit of the accunulator. 

V - Parity or overflow flag. This flaq is affacted by arithmetic 
and logical operations. If an overflow occurs durring an 
arithmetic operation, the flag is set to one. After a 
logical operation, the flag is set to 1 if the result of 
the operation has even parity. 
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VU 


N - Add/subtract flag, N=1 if the last operation waS a 


subtraction. 
Cc - Carry flag, C=l if the operation produced a carry. 


The E flag on the first line is the state of the interrupt enabled 


ae 


flip-flop (IFF). Tf interrupts are enabled, the “E" is  orinted, 


otherwise a space 15 printed. 
The A register is printed next, followed by the RC, OE, and BL 


register pairs and the stack pointer. The orogram counter value is then 
printed in both absolute and relative. The opcode pointed to by tre 
program counter is then displayed as an instruction. 

On the second line, the prime registers are displayed, F' (orime 
flags), A‘, BC', bE', and HL'. the I[%, Iy, and I (interrupt 7age) 
registers are printed next. If the disassemoled opcode includes an 
address, the relative value of this address is printed as the Last thiag 


on the line. 


-DR (CR) 
S H NCE A=00 BC=0308 DE=0000 HL=03998 S=0000 p=1234 9014' CALI 1334 


SZ NC A'=99 B'=8008 p'=9900 H'=0008 X=0000 Y=6908 12598 (@113') 


ew ee ee we wee ae we ee re ae ae ae a me 


a beeen 


The data port is read and displayed as 4 hexadecimal number. The 
Fornat of the command is 


E data-port (CR) 


In the following example the data port 3 is read and disclayed on 
the console. 


ow ees ee an ae ee a a OE wet a 


The format of the command follows. 


EJ 4d 


The d is the disk number (A, B, C, DD. If the designated disk is 
a CROMEMCO DUAL LISK SYSTEM model PFD, with the eject option, the 
diskette in the disk drive will eject. 
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<2 we oe om re ee oe ee ee mn ee 


ee tees 


This command allows the operator to insert filenames in the two 
default FCBs (at 5CH and 6CH) and the command line into the default 
buffer (at 88H). The example below loads FILE1l.cOM into the first FCB 
and FILE2.COM into the second FCB. The complete line is also loaded 
into the default buffer. 


-~FPILE1L.COM FILEZ.COM OPTION1 OPTION2 
This command can be used with the “R" command to read in disk files. 


oe 


The GO command has the following formah. 
G(starting-addr) /(sreakpoint-1) (breakpoint-2)... (breakpoint-5) 


Each of the addresses are optional. If the starting address is 
omitted, the the contents of the program counter is used. The registers 
are loaded from the user registers (these are the values disnlayed with 
the DR command). Execution begins with the starting address oF the 
contents of the program counter. If break points were specified, 4 
RST 3@H is inserted at the break point addresses and a jump instruction 
is placed at location 39H. When a oreakpoint is executed, control is 
returned to TRACE, and all of the user registers are saved (the registers 
may then be displayed with the DR command). ALL breakpoints are then 
removed from the user program. The program counter is displayed after 
the breakpoint. Note the following about breakpoints: 


(a) Breakpoints can only be set in programs residing in RAN, 
This is because a RST 36H is insected at each break point location. 
(The original contents of these locations are saved so that they can 
be restored after a break point is executed.) 

(b) Up to 5 break points can be set. If an attempt is made to 
enter more than 5 break points, the command will not be accepted. 

(c) When a oOreak point is used, a jump instruction is stored at 
location 38H. Therefore Locations 30H, 314, and 32H are not available 
to a user program. 


The GO command has an additional feature that is very helpful in 
debugging a program. A count is allowed for each break-point. This 
count is entered after the break-point and enclosed in parentheses. 
This count is the number of times the program reaches this address 
before control is returned to TRACE. A count of one says to break the 
next time the address is reached. In the exanvle below execution begins 
at location 194H and will break when address 1n9F is reached for the 
second time or when 1234 is reached for the first time. 


-C190/149(2) 123 


Note that 123 and 123(1) means the same thing. Also note that the 
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count is @ hexadecimal number. Therefore 123(F) means to break after the 
address has been executed for the 15th time. 


SO SR em me ee ee ee erm cs Om et ne ee a a ne co ce ee eee ee me 


TS RY ca ON a Se ee nem ne em ee ee nee ee oe es oe 


Hexadecinal addition and subtraction may be performed by this 
command. The first number to be Drinted is the sum of the two input 
numbers, The second number to be printed is the difference between the 
first number and the second number. In the exanple following, the first 
numoer is 1234 + 321, ang the second nurber is 1234 - 321. 


7H1234,321 
1555 @F13 


ee mc a ae ee ce ce am ae we are eee ee oe ee oe ee 


SP mom ee ce me arm em ye ma se ee ee ee ee ee ee ee 


The list conmand is used to list the contents of memory in 
assembly language mnemonics. The formats for this command are. 


GL (CR) 

L starting-addr (CR) - 
L starting-addr ending-addr (CR) 

L starting-addf 8 swath-width (CR) 
L,ending-addr (CR) 

LS swath-width (CR) 


The first format lists 16 lines of disassembled code starting from 
the current list address. The Second format lists 14 lines fron the 
Starting address. The third format lists from the starting address to 
the ending address. The fourth fortat lists from the Startina address 
for a length specifiad by the swath width. The fifth fornat lists from 
the current list address to the ending address. The sixth format Lists 
from the current address for a length snecified by the swath address, 

The first address of the disassembly is the absolute address. The 
second address is the relative address. If the disassembled instrvetion 
contains an address, the absolute address is nmrinted in the instruction 
in hexadecimal and the relative address is printed to the right of the 
disassembled line. In the example that follows, the "eg" register 
contains 2880. 


~LeSlR 812 
3602 8296" apr sR 


38°] 4801' CALL 3222 (GAaGB') 
3884 9864' CALL 3243 (ZA43') 
3067 $807' CALL 3333 (9P33') 


3804 086A' Le A,B 

3G9B 983E' OR C 

380C 883C' IR 22,3069 (2800!) 
3Q0F S80F' INC HL 

3618 4813" INC re 

3011 @811' INC eC 

3612 9812' Lr A,B 
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Mo~ MOVED MEMCRY 


ee ee ee we a eae ee ee 


Tne formats of this command follow. 


M source-addr source-end destination-addr 
M source-addr S swath-width Gestination-addr 


The first format moves the contents of memory beginning with the 
source address and ending with the source-~end to the destination 
address. The second forinat uses the swath width to determine the length 
of the move, 

The move is verified to insure that all bytes were moved correctly. 
If an overlappina move was made, errors will be reported. The error 
reporting can be terminated oy tyoing any character. 

The move command can be used to fill a block of memory with a 
constant. In the following example, a zero has been entered into 
location 1364 using the SM comnand. The following comrand will move 
zeros from location 19€H through 178, 


-"148 37 171 
Care should be taken not to move menory over TPACE or CEOS. 


eee ee ee ee ee oe ee ee ee ees 


O - OUTPUT TO TATA PORT 


ee eee cee me me ee te re eee ee ee oe ee ee ee oe oe 


This conmanid outputs data to a data nort. The following is tiie 
command format. 


O data~byte oort-i1umber (CR) 


er ee eee ee ae re cee ee ee ee 


P - PROCRA!’ PROMS 


This corrtand allows crogramming of PROMS. The following are the 
command formats, 


P scurce-addr source-end Jestination-addr 
P source-addr $3 swath-width destination-addr 
The first format programs PROMS starting with the source address 
and ending with the source-end into PROMs beginning at the destination 
address. The second fornat deteritines the length from the swath width. 
If the length of tne source is not a multisle of 489F or if the 
destination does not begin at a 4998 boundry, TRACE will reject the 
command. (“ultinles of 49784 end in '9849', '47H', '808', and 'c@a'.) 
Any nuvber of 2748 or 2774 PPO“S can be programtred in the execution 
of one cornand as lonqd 3s there are enouch PYTESAVEPS to contain then. 
Each PPO” is verified with its source after all are oroqrammed and anv 
discrenancies are orinted out. Tf no discrecancies are found, a cromnt 
1s oririted and the next command nay be entered. 


Other Trace Commands 57S 22222 Ss 2 


Software can be loaded into a PROM in as small increments as you 
desire, provided it is added to previously unused areas of the PROM. 
This is done by first using the Move command, "M", to transfer the 
contents of the PROM to RAM, adding the new software to an area of RAM 
which corresponds to the unused portion of the PROM and finally using 
the Program command, “P", to reprogram the PROM with the result. 
Athough the entire PROM must always be programmed, it never hurts to 
rewrite the same data over again. In general, a 1 may be written over a 
1, a @ over either al or a 4, but the only way to change @'s to l's is 
to erase the PROM with appropriate UV light. (See the BYTESAVER manual 
for details.) 


me ce eee ae ae ee ee ee ee ee ee se 


R - READ DISK FILE 


This command allows the operator to read a disk file. The "BR" 
command is used with the "F" command. The "F" command is used to 
Specify the filename, and the "R" command reads in the file. If tne 
file has an extension of ".HEX", then the file is an INTEL HEX file and 
will be read into memory. Any other file is considered to be a binary 
file and will be read directly into memory beginning at location 1308. 
The format of the "R" commmands is 


R 
R displacement 


The first format reads the file with no displacement. The second 
format reads the file with a displacement. If the input file is in HEX, 
then the displacement is added to the addresses in the file to 
determine the addresses at which to store the file. If the file is a 
binary file, it will be stored at the displacement + 19@H. 

When the “"R" command is executed, TRACE prints either a "?" if 
there is an error (file not found, checksum error, or file attempting 
to read above highest available memory location) or with the following 
message if there is no error. 


NEXT = xxxx 


Where xxxx is the address of the next available memory location 
past the end of the file. 


SM - SUBSTITUTE MEMORY 


This command is used to substitute memory. The format of the 
command follows. 


SM starting-addr 


TRACE prints the absolute address, followed by the relative 
address, followed by the contents of the memory byte. One of the 
following may then be entered. 
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(a) data-byte value. The data byte value is stored at the 
address of the prompt. The address is then incremented 
by 1 and disolayed on the next line. 

(3) string enclosed in quotes. The string is stored beginning 
at the address of the prompt. The address is then incremented 
past the string and displayed on the next line. 

(c) Any number of (a) and (b) above can be entered on one 
line. The address is then incremented past the bytes that 
were stored and the new address is displayed on the next 
line. 

(d) "-". A minus sign does not store a byte. The address 
will be decremented to the previous address. The minus 
sign can be used to "back up" cto a previous location ina 
case an error has been made. 

(e) (CR) only. If no entry is made on the line, the memory 
byte remains unchanged. The address is incremented by 1 and 
displayed on the next line. 

(£) period. A period ends the input mode and returns to the 
command level. 


In the example that follows, assume that the "@" register contains 
the value 2809H. 


~OMelLAF 

2999 0149' 32 4 

2901 9191' 17 496 

29482 8142" 31 'THIS IS AN ASCII STRING’ 
2919 9119' 7A 'AAAA' @ 612345678 29 


tele tien Teee Ee teal erate Eee ee ee eee 


Sct - SUBSTITUTE RECISTEP 


em ee cm ce coe ee a wee te eee ee ee aes eee ee ee eee i ee 


The Sr command allows the user registers to be altered. The 
letter "r" stands for the register which is to be changed. The 
section SUMMARY OF REGISTER NANES gives a summary of the names 
that can be substituted. When substituting the F and F' flags, enter the 
command SF or €F'. TRACE will then print the flags that are set and 
wait for the overator to enter the nanes of the registers that are to be 
set. If the flags are NOT entered, the flags are reset. In the followiag 
example, the "SZHC" flags are set. After the example is executed the 
"ZC" flags are set. The lower case letters are entered by the operator. 


~sf 
SZH C ze 


When substituting a one byte register, a one byte value is eccerted. 
When substituting a two byte register, a two byte value is accepted. If 
no value is entered, or if an error occurs, the value of the register 
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remains unchanged. In the following example, the A register is changed 
to contain 414, 


ee ee ee ae ee oe ee ee 


A ee ce ane ee ae mim te oe 


The format of trace is 
T (CR) 


When this command is executed, TRACE will prompt the user for 
information regarding the program to be Simulated. At this time, 
Start and stop addresses, data areas, interrupts, I/O and other 
Parameters will be set up for the next TRACE to be initiated. Pefer 
to Chapter 3 for a complete explanation of the TRACE sinulation 
commands, 


ee cee a ee Ae ee ae ee ee cs es ee ee ee 


— ee cee eee ae ee cee ee ee ee ees re ee ee ae 


Verify that the block of menory between source address and source 
end contain the same values as the block beqinning at destination 
address. The addresses ang contents ace printed for each discrepancy 
found. The following is the format of this command. 


V source-addr source-and destination~-addr 
V source—addr S$ swath-width destination~addr 


This command works by reading bytes from the source and destination 
and comparing them. If a discrepancy is found, the memory 1S read again 
for print~out. Thus, it can happen that a discrepancy is printed-out 
with the source and the destination contents indicated to be the same, 
This is caused by a defective memory element. 

A discrepancy is printed in the followiag order: source address, 
source contents, destination contents, destination address. In the 
example that follows, memory locations 13638 and 134908 are defective, 


-V 9 S39 13569 
6993 32 12 1493 
@838 74 5A lage 


~ 
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a ee 


Summary Of Trace Commands 


nan neem ne oma eee oe 
ee 


The following is an alphabetical List of the TRACE commands. 


Command 


Descrintion 


Assemble into memory 
Continue with Trace 
Continue with No Printing 
Display Memory 

Display Register 

Examine input nort 

EJect disk 

Specify disk File name 

Go 


Hexadecimal arithmetic 


List in assembler mneronics 


Move memory 

Output to data port 
Program PROMs 

display circular Gueue 


Read disk file 


Substitute Memory 


Substitute register 
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COMMAND 


initialize 
initialize 
initialize 
initialize 
initialize 
initialize 
initialize 


initialize 


DESCRIPTION 


set up Trace parameters 


Trace 


Trace 


Trace 


Trace 


Trace 


Trace 


Trace 


Trace 


Data areas 

Halt addresses 
Interrupt list 
iNput channel list 
Output channel list 
oPtions 

Restart addresses 


Stop addresses 


display Total elapsed Time in machine cycles 


put Trace stack above User stack 


initialize Trace display on Write areas 


Verify memory 
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Summary Of Register Names 


The Following register names are printed by the DM command and should 
be used with the Sr command. 


Register Decrintion 


Flags, the following flags may be changed. 
S$ - Sign flag 

- Zero flag 

- Half carry flag 

parity/oVerflow flag 

- subtractioti flag 

- Carry flag 


QA2dms 
1 


Tne interrupt enable flag ("E") may also be changed. 


F! The F' Flags are the same as the "F" flags. 
(mote that the "E" flag may not be changed here.) 

A accumulator 

A! prime accunulator 

B BC register pair 

B! BC’ register pair 

D DE register pair 

D' DE' register pair 

is HL register pair , 

q' qHL' cegister voair 

S Stack pointer 

P Program counter 

X IX register 

Y IY register 

I Interrupt page register 
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Trace Sample Run 322338 2333 HS 


TYPE SAMPLE. PRN 
CROMENCO COOS fom ASSEMBLER Y 1. 4A 


»TEST PROGRAM FOR TRHCE GOCUMENTHT 1c 


? 


Se 
m 


Cet) 


iS as 
UAt fae pF 


“yt 
I 
1 
are 

Dany 


OG 14 
BE 


iH 
MONIT EGU HEC 


OHGH Fs MONITOR ACCRESS 


i 
Soft iE 
mo iS 
nt 


[xy 
Lax 
Se 
a1 
~ 


SIMITIALICE FEGISTERS ANG MACHINE STATE 


BBY 5 
LHW FA wane START: DI ” 
W184 315504 Ta ae Lop SP, STACK +204 
Wikked Gticws oda Los BC, FLIRT »FALSE RETUPN ACCRESS 
bier 2loesaL Gait LG HL. SOURCE 
WLWA LLASSL wns LB DE. DEST 
MiB SEs wed > LG A: 2 
BLOF SZACHL aui4d LD CGO0Db a. A SHRITE TO oH CATR AREA 
Mite COosmad BuLs CALL SUBR » SUBROUTINE WHITH 
HHS -AM UNPAIPED PUSH 
Mii wa wat? Mop 
Bilis SEed WO FLORT LD FL iH »SUBP RETURNS HEE 
Wiis bod? me19 LO I. A SINDTIHLICE INTERRUPT br Tote 
@LiAn EDGE 5 5 TMez _ SSET INTERRUPT Mote 
B1ic FE alsa 8 EI /ENHBLE [NTERPURT 
iil L2 nas LD 1OE4.A 
MILE Bl ioe | aes LD BC, Le CINITIALIZE Fur LOTR 
Sts Pane a Pee hte pe pe THE SIMULATED INTEPFUFT OCCURS HERE +tt+ tee 
wae i 
Bist EDEE Bitetc: LOTR iPLOWCK TRANSFER 
cs Pear -END UF BLOCK WRITES To 
wages 5 SAM UNDECLARED PEGION OF MEMORY 
igs wLlFFis SiS) LD Bil, LOFFH SIHGTIALIZE Fur GLOCk TNPuT 
MELA. »FROM CHANNEL GFFH 
Bice EDGAR me INDF 
Bich goo nals Lt EB. 18 
BLS EDGT SS: OT IF BLUR OUTFUT OM SIMULATED CHRMNEL 
Biet FCSLed OT 4 TALL ff. SUBRL »SIGM FLAG M07 DEFINED AFTER UTIF COMMAND 
OHAlS 3 
HAL eererreite CONTROL PASSES To THE USER PROGRAM AT HIS POINT erteeretee 
BOLT. . 
BiSrF Zr Hale INCZER INC A 
Wilt SOF Se IF He. Thi CEP 
Wd ote rete kert keto ee eee eHRESUME TRACE WHEN WE EMIT THIS cities rr eeeeeetaee 
Wadi. 
Mite GOL Shel Beds Lo Tx. SOURCE 
ps a BB Ho4+2 os) OCH, OAH 7A 2-BYTE UNDEFINED COMMAME: 
M1638 Obboas no44 OF CUK+Ss 
Nile Cloges Ente S IF MONIT 
WISE Hide. OF LTEH DFS VECTOR Fur TNTERRUPT 
LTE Sigi mii Cd SUGFL 
BiH. 
SB 5 a Bod SUR FLISH Be CS7ORPE FHLIE RETUPN HOOPRES=. Ore ITAL; 
BLSi Cane mote SUERL = AD ot SENTRY FUP MORMAL SubP UU INE 
Biss C8 Both FET 
meas . eee eee eee te eee EDAT AS AREA ree tree tee 
Bas 
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Biss waed4: Mat STACK. GCEFS 20 
WMiSS (BHA) BEES SOURCE GDEFS Lh 
MLAS CAHIR & waoq CEST: CEFS it 
BLAC (Hed) Basy GOOG DEFS 1 
WS 
SLAB MOSS EMD 
Bae EPFORS 
*. TRACE SAMPLE. HES The program "SAMPLE.HEX" is to be Traced. 
TRACE VERSION 2. 11 
NEXT = Bod 
-T 
Ve. 18 
START ADDR? Lan 
STOF ADDRCS> ?$+25 
25a) 
L 
DATA AREAS LeoLOW ADR. HIGH ADDR? 
44. LAC L 
DISPLAY GN WRITE. L&oLON ADDR. HIGH ADDR 
iss ise+ia 
L 
EXTEND OPTCY OR NOY 
REAL TIME. INPUT CH Vite FRGL 
OUTPUT CH cig>> FFOL 
TRACE STOPCS9> Lorik 
TRACE RESTART: S.° i523 
INTERRUPTS: 1a 0. ADDR. COMM. PASS. TIMES 
4416. TE, 1,43 
L 
INTERRUPT MODE? 
OPTIONGC 237 a2 Prints all machine state info after every instruction. 
-C# Trace continuously from the start addr specified above. 
INSTF FLAGS ABO DE HL IX Iy¥ 
eaine BG BHO Oe Bone Boe Boe DI 
4 Be Boe Bea Boe These are the "prime" registers. 
T=a4 SP= aaa vSPo= SLFr 
medial MY nn Gi Be Boe Bed Lb SP. odds 
i4 SP= etse (SP 3= wean Stack Pointer and contents. 
alot WO Wild Bee Bee Bene bond LD BO a@iie 
24 
eyLa? Wa Wiic Gon aise Boe Bae LO HL, aioe 
34 
clam a WA Bite GLAS ELSE Be Gite LO DEL ate 
44 
Bailar He ile BLAS Biss wae Boe LO A. BS 
od 
Guar a Wiis GlAZ BlSe Oh oon LO eta A 


Trace Sample Run 


maLite 
@@i1E 
mMLLE 


Be@LLE 
ae 


rae 


TS tar + im 
Cm Mt Se Ose 
Ge ee pe 


Gat 
Psy 
Pech Pe She bo OR On Pe Db Oe ba 
2 re Ts 


| oo 


Ll fa Pat 
va fs fat 


mz 
Chr tts 


fenal 
= 


na! 


it Os oa re 
foo fe Th ute or, 
Oy, 


ce 


fora 
sty 


mp Re 


t 


iT) 07, 


‘at 
4 
pet 


h Po be tt 


Para. ha 


W2 Blie Wife B192 Bao one CALL OSG 

SPs Gite rSP y= W115 
Wo lic BLAS LSS Gee bead PUSH BC 

Po Bids 1SP3= GLic 
Oo B41is OLAS 8198 ged OO00 ADD oe 

ereebeeee RETURN EPROP (due to the PUSH BC above) 
WAS EMPECTED. ARTURL PETUPN ADDS giie 

OS Bilis BLAS Ble Babe Gade FET 

SP= wite 6oFus Biis 


eee Ses es eee Ue came 
=— a Se SS I = 


FLAGS A BC BE HL Ik [fy 
Wl Bide wine BLSe Bowe Good Lo A. aL 
Oi B1ib GiAs Biss oo oooe Lo oT. A 
[=51 Interrupt register initialized. 
HL Adis OLAS Biss Gone Bond IM es 
M1 H1ie glAS Biss we Geni £1 
E 81 iin GLAS S198 GG Gade LO DEA 
WLiAS =41 
TNT MeO2 Taal INT="E LEV=a1 Simulated interrupt. 
M1 Wiis a1Ac Bis oom Boon 
SF= Bic .SPo= BLLE 
WP Bilis BLAS Bite Boo Ged AbD oes 
Of Wiis 1S GLSe Goo Oe RET 
SPS B56 CSF3= A115 
MF GOLA BLAS A195 Bono Bao LD BC. aoLG 
wiAZ To BLiB1 Block transfer to display on write area 
BO Oe Ge Oo Go oo oe _overlaps into a non-specified area. 
reteeee t+ MEMORY WRITE HOT IN A SPECIFIED FEGION 
O44 00 0 ao Be 
OF BOO LBS BLAS Bo oon LOTR 
@f LFF ALES OLAS Gooe wood LEO BC. LOFF 
Bigs To OLAe 
FF FF FF FF FF FP FF FF FPF FF FF FF FF FF FF FF 
FLAGS A Bt ODE HL Ik [? 
SHVHC Oy SWFF BIBS G195 fom0 ano Inte Real time input 
(values above) 
CHYNC GF SAFF BLbo aioe tee oo80 LD GE. OAR 
SH NC BY GOFF GLBS G1Ae eho food OTIR 
etyeeetee TRANSFER CN INDEFINITE FLAG Sign flag not defined 
CHNC OF GOFF BIBS BLAS O00 Geen CALL NM ated 


Trace Sample Run 


itn 
TS cH C WM BUFF GLB LHe OLS ben LD Ti. O138 
Lie 
BML ot etteeteese UNDEFINED INSTRUCT Iuits The 2-byte instruction 
Ob A DD OA is undefined for 
the Z-80 
id or eertteee ee STOP ADL Control returns to the 
monitor. 
Pea@ive wise 
—i Display contents of Queue buffer. 
DMS FLAGS A o.SP% 
+H 1.2 eH © Ot O145 
tLe eH NC BP WLS 
+01FI CH ND 87 BLLS 
+ L288 CHYHE 87 115 
+426 AHVHO YALL 
+1. wy Odi5 
+412 wr WLS 
+H1L1E ay ALLS 
+857 a7 BLIS 
+H L541 WF ALE 
+H LE WL BiLE 
+HL 10 E Oi Hiis 
+H 0 M1 S115 
tHi LA Wi @1is 
HALLS Ad wii 
+OLi6 WL e115 
Ha Lt We Hil 
+6484 Mm Bile | 
+H LS Me Ollie 
+H1Ls we HLis5 
rH LF Wo oe 
+0 1u0 Hel tee 
+010 STS MES ISIS) 
+Hig7 ii cee 
+1045 a Se 
THLOL Mey CS 
+0105 aa TAFT 


Cromemco’ 
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